home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / pns51.zip / COMMOPNS.DOC next >
Text File  |  1991-09-30  |  9KB  |  276 lines
  1.  
  2.  
  3.                            ┌──┌─┐┌┐┐┌┐┐┌─┐┌─┐v5.1
  4.                            └──└─┘└ ┘└ ┘└─┘│─┘ ┌─┐
  5.                            D&M Enterprises│┌─┐└─┐
  6.                                           ││ │└─┘
  7.  
  8.  
  9.  
  10.                             September 30, 1991
  11.  
  12.                                 Shad Muegge
  13.                               Marcos R. Della
  14.  
  15.  
  16.                                  ____
  17.                        -------|\/ o  \------------------
  18.                           ____|    ,__| Association of
  19.                          /  o \/|____/  Babble Fish
  20.                         |__,    |____   Programmers
  21.                          \____|\/ o  \
  22.                               |    ,__| MEMBER
  23.                        -------|/\____/------------------
  24.  
  25.  
  26.        COMMOPNS is shareware, which means that you can use this program
  27.        for 30 days to decide whether you want to use it.  If you decide
  28.        you are going to use COMMOPNS, you must send in the registration fee.
  29.  
  30.        Send your COMMOPNS registration fee of $10.00 US to:
  31.  
  32.             Shad Muegge
  33.             P.O. BOX 4251
  34.             Santa Rosa, CA  95402
  35.  
  36.        This is a LIFETIME registration fee, meaning that you will never
  37.        have to pay for any future versions of COMMOPNS.
  38.  
  39.        COMMOPNS may be freely distributed in its original PKZIPed form.
  40.  
  41.        SUPPORT:  You can either send me a letter, to which I will gladly
  42.        respond, or you can call my BBS: The Babble Underground (707) 575-0636.
  43.  
  44.        Thanks to:
  45.           Fred P. Brucker for writing {COMMO}.
  46.           Tom Keller, for editing this file.
  47.           And everyone else who Beta Tested COMMOPNS.
  48.  
  49. BASIC CONCEPT:
  50.  
  51.       COMMOPNS.EXE - Displays a single directory at a time and
  52.         allows the user to TAG files.  When the program is exited,
  53.         it writes the TAGGED files out to a specified (or default)
  54.         file.
  55.  
  56. OPERATION:
  57.  
  58.     An up arrow in front of a name indicates a subdirectory which will
  59.     lead you up the directory tree.  Likewise, a down arrow indicates
  60.     a subdirectory which will lead you down the tree.
  61.  
  62.     COMMANDS:
  63.        <ENTER> Change to a SUBDIR.
  64.  
  65.       <ARROWS> Moves selector bar around.
  66.  
  67.  <PGUP> <PGDN> Switches file display pages.  Useful if your directory
  68.                has more than 115 files in it!
  69.  
  70.   <HOME> <END> Move to the first/last item on the screen.
  71.  
  72.        <SPACE> Toggle the tag flag, and advance to next file in the display.
  73.                Also updates approximate upload time estimate, if the -S
  74.                option was specified on the command line.
  75.  
  76.      <Any Key> Advance selector bar to filename starting with that key.
  77.                For example: Press M to jump to filenames starting with M.
  78.  
  79.           <F1> Bring up a small help list.
  80.  
  81.        <ALT-D> Change the drive.
  82.  
  83.          <ESC> Exit and write tag file list.
  84.  
  85.  <ALT - F1/F2> Change colors for foreground/background main screen.
  86.  <ALT - F3/F4> Change colors for foreground/background highligh bar.
  87.  <ALT - F5/F6> Change colors for foreground/background status lines.
  88.  
  89.        <ALT-C> Save colors and display method (BIOS/Direct).
  90.  
  91.        <ALT-U> Toggle between BIOS and Direct screen writes.
  92.  
  93. BASIC IMPLEMENTATION:
  94.  
  95.         DSZ, MPt, and others allow a list of files to be specified
  96.         in a file.  For example:
  97.                     DSZ sz @C:\FILE.LST
  98.                     MPt s @C:\FILE.LIST
  99.  
  100.          will upload all the files in C:\FILE.LST.
  101.  
  102.          In DSZ, the @, the drive letter and the : are all MANDATORY.
  103.  
  104.                                 PAGE 1
  105.  
  106.       Getting COMMOPNS to work with your terminal program, should be
  107.          simple, here's a example in a psuedo-terminal program
  108.          script language:
  109.  
  110.          Execute COMMONPNS C:\FILE.LST
  111.          Execute DSZ sz @C:\FILE.LST    { for ZMODEM  }
  112.       or Execute MPt s @C:\FILE.LST     { for MPt }
  113.          Execute DEL C:\FILE.LST        { this is optional }
  114.  
  115.  
  116. SETUP FOR {COMMO}:
  117.  
  118.       1. Put COMMOPNS.EXE somewhere in your path.
  119.  
  120.       2. Insert the COMMOPNS.MAC file into your COMMO.MAC
  121.          file - using your favorite ASCII text editor.
  122.  
  123.       3. Load {COMMO}.
  124.  
  125.       4. Type <Ctrl-PageUp> to get COMMOPNS Upload Menu!
  126.  
  127.       5. UPLOAD UPLOAD UPLOAD
  128.  
  129. AUTOMATIC COMMOPNS in {COMMO} with ZMODEM!
  130.  
  131.       In COMMO.SET file, insert the line:
  132.         {aut=pnszup,^xB01}
  133.       Now, whenever you do a Zmodem upload, COMMOPNS will automatically execute.
  134.  
  135. SETUP IN A BATCH FILE:
  136.  
  137.    For Upload: Some terminal programs allow you to call external
  138.                batches for their file transfer protocols.
  139.  
  140.       Example Batch File: (Zmodem or MPt Upload)
  141.  
  142.       @ECHO OFF
  143.       COMMOPNS C:\FILE.LST
  144.       DSZ sz @C:\FILE.LST
  145.    or MPt s @C:\FILE.LST
  146.  
  147. USE WITH PKZIP:
  148.  
  149.     This will allow you to pick files out of single or multiple
  150.     directories and zip them together.  Note that additional command
  151.     line parameters can be added to the PKZIP line to preserve paths, etc.
  152.  
  153.    PNSZIP.BAT:
  154.       @ECHO OFF
  155.       COMMOPNS C:\FILE.LST
  156.       PKZIP -a %1 @C:\FILE.LST
  157.  
  158.    Example command line:
  159.         PNSZIP PNSSRC.ZIP
  160.  
  161.                                  PAGE 2
  162.  
  163. PARAMETER DEFINITIONS:
  164.  
  165.    - if no parameters are specified, then the file list is CREATED
  166.      in the DEFAULT drive ROOT directory.
  167.       (i.e. if COMMOPNS is run on C:, the file would be C:\FILE.LST)
  168.  
  169.    COMMOPNS [DRIVE:][PATH][FILEN] [-O<N|T|E>] [-D[DRIVE:][PATH][FNAME]] [-S<bps>]
  170.  
  171.          DRIVE: The drive where you want the file.
  172.                         (ie. C:, D:, ... )
  173.          PATH: The path where you want to file.
  174.                         (ie. \COMMO\)
  175.          FILEN: The file name, you want the list to be written.
  176.  
  177.          An Error Level 2 is returned for invalid tag list filename.
  178.  
  179.          -D: Optional directory in which to begin tagging.  The drive
  180.              specifier is only necessary if you wish to start up on a
  181.              drive other than the current drive.  Will allow wildcard
  182.              filename specifications (ie. *.pas) to choose only
  183.              selective files
  184.  
  185.          -S: Modem transfer speed, in Bits Per Second.  If this option is
  186.              specified, COMMOPNS will compute and display the approximate
  187.              time needed to transfer the tagged files.
  188.  
  189.         -ON: Sort in order of filename. (Default)
  190.         -OT: Sort in order of date & time.
  191.         -OE: Sort in order of extension.
  192.  
  193. ENVIRONMENT VARIABLE:
  194.  
  195.         Setting a COMMOPNS environment variable in DOS will tell COMMOPNS
  196.         where to write the list of TAGGED files.
  197.  
  198.         For Example: SET COMMOPNS=C:\FILES.LST
  199.  
  200.         This will cause COMMOPNS to write the file list to C:\FILES.LST
  201.  
  202.         Specifing a name on the command line will override this environment
  203.         variable.
  204.  
  205.  
  206.                             
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.                                 PAGE 3
  219.  
  220. REVISION HISTORY:
  221.   Version            New Stuff/Fixes.
  222.  
  223.     5.1   BIOS calls removed and DesqView calls installed to support
  224.           virtual screens.  Changed the file specification option to
  225.           allow for wildcard specifications (ie: *.pas).  Fixed small
  226.           color problems and help file.
  227.  
  228.     5.0   Major re-write of the basic code to increase speed.
  229.           COMMOPNS enviroment variable added so you can specify the
  230.             file to be created by the program.
  231.           ErrorLevel 1 returned if there is an empty file list.
  232.           Direct Video writes re-written in assembly to increase display
  233.             speed to the screen.  BIOS calls still in place for DV users.
  234.           Alt-U added to toggle between BIOS and Direct Video writes.  This
  235.             parameter can be saved using the Alt-C (clone) option.
  236.           F1 now brings up a help screen with the basic commands.
  237.           Pressing a key to jump to a file
  238.           Error level 2 returned for invalid tag file list filename.
  239.  
  240.     #.#   These versions skipped in a cheap marketing attempt to cash in
  241.           on the version 5.0 mania.
  242.  
  243.     2.1   Bug fixes.
  244.  
  245.     2.0   Added color and ability to change colors.
  246.       -D start directory option.
  247.           -S Bits Per Second option, so COMMOPNS can display upload time.
  248.       Arrows for indicating directories.
  249.           Checks memory available, instead of crashing.
  250.  
  251.     1.5   Fixed up a bunch of stuff in the doc files.
  252.       Added the current directory display to the top of the screen.
  253.           Add BIOS/Direct screen writing for snowy CRT's and multi-taskers.
  254.           Advance to next file after tagging a file.
  255.  
  256.     1.1   Modified to use a lot less memory.
  257.  
  258. BUGS: (bugz), adj. [Slang], 1. crazy; insane. 2. any crawling insect
  259.  with sucking mouth parts and forewings thickened. 3. Problems with a
  260.  computer program.  (go figure!)
  261.  
  262.  - The program doesn't seem to work on the novell network. When it
  263.    reads in the directory, it doesn't find a ".." parent directory
  264.    file.
  265.  
  266. DETAILS:
  267.    {COMMO} is a product of Fred P. Brucker.
  268.    DSZ is a product of Omen Technology Inc.
  269.    PKZIP is a product of PKWARE, INC.
  270.    MPt is a product of Matthew Thomas.
  271.  
  272.  
  273.  
  274.                                 PAGE 4
  275.  
  276.